home *** CD-ROM | disk | FTP | other *** search
/ Languguage OS 2 / Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO / gnu / libg_261.zip / libg_261 / libg++ / README.SHLIB < prev    next >
Text File  |  1994-10-20  |  10KB  |  341 lines
  1. NOTES ON BUILDING LIBG++ AS A SUNOS4 SHARED LIBRARY
  2.  
  3. A shared library version of libg++-2.6.1 can be built using gcc-2.6.0 on a 
  4. SPARC10 running OS4.1.3. In order to get SUN shared libraries to work 
  5. properly with g++ it was necessary to patch collect2 [ld].  A hack of an 
  6. earlier version of collect2 done by Eric Schenk [schenk@cs.toronto.edu] was 
  7. massaged to work with gcc-2.6.0.  A context diff is included below.
  8.  
  9. To build a shared version of libg++ on a SPARC running OS4.1.3 
  10. do the following:
  11.  
  12. (0) patch collect2.c in gcc-2.6.1 and rebuild
  13. (1) patch libg++-2.6.1
  14. (2) start with a *clean* libg++-2.6.1 tree [make distclean] 
  15. (3) configure
  16. (4) edit the top-level Makefile:
  17.  
  18.     CC = gcc
  19.     CFLAGS = -g -O2 -fpic
  20.     CXXFLAGS = -g -O2 -fpic -fno-implicit-templates
  21.  
  22. (5) run make
  23. (6) build the shared lib from the PIC code
  24.     (a) cd libg++-2.6.1/libg++
  25.     (b) mkdir shared
  26.     (c) cd shared
  27.     (d) ar xv ../libg++.a
  28.     (e) mkdir unshared
  29.     (f) mv CursesW.o  ./unshared
  30.     (g) ld -o ../libg++.so.2.61 *.o -assert pure-text
  31.     (h) cd ./unshared
  32.     (i) ar rcv ../../libg++.sa.2.61 *.o
  33.     (j) ranlib ../../libg++.sa.2.61
  34.  
  35.  
  36. Discussion:
  37. ----------
  38.  
  39. The SUN link editor has an idiosyncracy [bug ???] which requires anything
  40. that is declared in a shared library to be defined even if it isn't used.
  41. CursesW.o declares functions that are defined in libcurses and libtermcap. 
  42. If CursesW.o had been incorporated into the ".so" piece, these two 
  43. libraries would  have to be added to the link statement even when the 
  44. CursesWindow class is not being used.  This situation was alleviated by 
  45. placing CursesW.0 into the ".sa" piece.
  46.  
  47. In addition, libg++.so.2.61 contains a number of classes which use the math
  48. library.  Consequently, the math library must to added to the link command
  49. even if these classes are not used.  There are far too many of these classes
  50. that declare math functions so it is just easier to add "-lm" to the link
  51. command.  One might consider splitting libg++ into two libraries: one that
  52. contains the contributions from libio and libiberty and another that contains
  53. Doug Lea's classes.  I've done some experimenting in this direction and have
  54. seen that such an approach is certainly viable.
  55.  
  56.  
  57. -----------------------collect2.c patch---------------------------------------
  58. *** collect2.c.orig    Mon Jul 11 15:08:16 1994
  59. --- collect2.c    Sun Jul 31 09:38:09 1994
  60. ***************
  61. *** 24,29 ****
  62. --- 24,34 ----
  63.   the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.  */
  64.   
  65.   
  66. + #ifdef sparc
  67. + #define SUNOS_SHARED_LIBS /* This should really be defined in a config file */
  68. + #endif
  69. + 
  70. + 
  71.   /* Build tables of static constructors and destructors and run ld. */
  72.   
  73.   #include <sys/types.h>
  74. ***************
  75. *** 223,231 ****
  76. --- 228,243 ----
  77.   static struct head constructors;    /* list of constructors found */
  78.   static struct head destructors;        /* list of destructors found */
  79.   
  80. + #ifdef SUNOS_SHARED_LIBS
  81. + static struct head shared_libs;     /* list of shared libraries to scan */
  82. + #endif
  83. + 
  84.   extern char *getenv ();
  85.   extern char *mktemp ();
  86.   extern FILE *fdopen ();
  87. + #ifdef SUNOS_SHARED_LIBS
  88. + static void  exec_ldd ();
  89. + #endif
  90.   
  91.   /* Structure to hold all the directories in which to search for files to
  92.      execute.  */
  93. ***************
  94. *** 1181,1186 ****
  95. --- 1193,1211 ----
  96.   
  97.     scan_prog_file (output_file, PASS_FIRST);
  98.   
  99. + #ifdef SUNOS_SHARED_LIBS
  100. +   /* Call ldd to determine dynamic depenencies, */
  101. +   /* and scan all .so files as well. */
  102. +   exec_ldd(output_file);
  103. +   {
  104. +     struct id *lib = shared_libs.first;
  105. +     while (lib) {
  106. +       scan_prog_file (lib->name, PASS_FIRST);
  107. +       lib = lib->next;
  108. +     }
  109. +   }
  110. + #endif
  111. + 
  112.     if (debug)
  113.       {
  114.         fprintf (stderr, "%d constructor(s) found\n", constructors.number);
  115. ***************
  116. *** 1328,1333 ****
  117. --- 1353,1470 ----
  118.   
  119.     do_wait (prog);
  120.   }
  121. + 
  122. + #ifdef SUNOS_SHARED_LIBS
  123. + static void
  124. + exec_ldd (outfile)
  125. +      char *outfile;
  126. + {
  127. +   void (*int_handler) ();
  128. +   void (*quit_handler) ();
  129. + 
  130. +   char *ldd_argv[3];
  131. + 
  132. +   int pid;
  133. +   int argc = 0;
  134. +   int pipe_fd[2];
  135. +   char *p, buf[1024];
  136. +   FILE *inf;
  137. + 
  138. +   ldd_argv[argc++] = "ldd";
  139. +   ldd_argv[argc++] = outfile;
  140. +   ldd_argv[argc++] = (char *)0;
  141. + 
  142. +   if (pipe (pipe_fd) < 0)
  143. +     fatal_perror ("pipe");
  144. + 
  145. +   inf = fdopen (pipe_fd[0], "r");
  146. +   if (inf == (FILE *)0)
  147. +     fatal_perror ("fdopen");
  148. + 
  149. +   /* Trace if needed.  */
  150. +   if (vflag || debug)
  151. +     {
  152. +       char **p_argv;
  153. +       char *str;
  154. + 
  155. +       fprintf (stderr, "%s", "/bin/ldd");
  156. +       for (p_argv = &ldd_argv[1]; (str = *p_argv) != (char *)0; p_argv++)
  157. +       fprintf (stderr, " %s", str);
  158. + 
  159. +       fprintf (stderr, "\n");
  160. +     }
  161. + 
  162. +   fflush (stdout);
  163. +   fflush (stderr);
  164. + 
  165. +   /* Spawn child ld on pipe */
  166. +   pid = vfork ();
  167. +   if (pid == -1)
  168. +     fatal_perror ("vfork");
  169. + 
  170. +   if (pid == 0)                       /* child context */
  171. +     {
  172. +       /* setup stdout */
  173. +       if (dup2 (pipe_fd[1], 1) < 0)
  174. +         fatal_perror ("Dup2 (%d, 1)", pipe_fd[1]);
  175. + 
  176. +       if (close (pipe_fd[0]) < 0)
  177. +         fatal_perror ("Close (%d)", pipe_fd[0]);
  178. + 
  179. +       if (close (pipe_fd[1]) < 0)
  180. +         fatal_perror ("Close (%d)", pipe_fd[1]);
  181. + 
  182. +       execv ("/bin/ldd", ldd_argv);
  183. +       fatal_perror ("Execute %s", "/bin/ldd");
  184. +     }
  185. + 
  186. +   /* Parent context from here on.  */
  187. +   int_handler  = (void (*) ())signal (SIGINT,  SIG_IGN);
  188. +   quit_handler = (void (*) ())signal (SIGQUIT, SIG_IGN);
  189. + 
  190. +   if (close (pipe_fd[1]) < 0)
  191. +     fatal_perror ("Close (%d)", pipe_fd[1]);
  192. + 
  193. +   if (debug)
  194. +     fprintf (stderr, "\nfind dependencies on shared libraries.\n");
  195. + 
  196. +   /* Read each line of ldd output.  */
  197. +   while (fgets (buf, sizeof buf, inf) != (char *)0)
  198. +     {
  199. +       int ch, ch2;
  200. +       char *start;
  201. +       char *end;
  202. + 
  203. +       /* Skip lines that complain about static linking */
  204. +       if (strstr(buf,"statically linked") != 0) continue;
  205. + 
  206. +       /* Find end of library name and null-terminate it.  */
  207. +       end = &buf[strlen(buf)-1];
  208. +       if (*end == '\n') (*end--) = 0;
  209. + 
  210. +       /* work backwards to find the start of the library name */
  211. +       start = end;
  212. +       while (!isspace(*start)) start--;
  213. +       start++;
  214. + 
  215. +       add_to_list (&shared_libs, start);
  216. + 
  217. +       if (debug)
  218. +         fprintf (stderr, "\t%s\n", buf);
  219. +     }
  220. + 
  221. +   if (debug)
  222. +     fprintf (stderr, "\n");
  223. + 
  224. +   if (fclose (inf) != 0)
  225. +     fatal_perror ("fclose of pipe");
  226. + 
  227. +   do_wait ("/bin/ldd");
  228. + 
  229. +   signal (SIGINT,  int_handler);
  230. +   signal (SIGQUIT, quit_handler);
  231. + }
  232. + #endif
  233.   
  234.   
  235.   /* Unlink a file unless we are debugging.  */
  236. -------------------------libg++-2.6.1 patches--------------------------------
  237. *** ./libg++/src/DLList.h.dist    Thu Oct 20 11:25:30 1994
  238. --- ./libg++/src/DLList.h    Thu Oct 20 14:24:13 1994
  239. ***************
  240. *** 52,58 ****
  241.       virtual void delete_node(BaseDLNode*node) = 0;
  242.       virtual BaseDLNode* copy_node(const void* datum) = 0;
  243.       virtual void copy_item(void *dst, void *src) = 0;
  244. !     virtual ~BaseDLList() { }
  245.   
  246.       Pix                   prepend(const void*);
  247.       Pix                   append(const void*);
  248. --- 52,59 ----
  249.       virtual void delete_node(BaseDLNode*node) = 0;
  250.       virtual BaseDLNode* copy_node(const void* datum) = 0;
  251.       virtual void copy_item(void *dst, void *src) = 0;
  252. !     virtual ~BaseDLList();
  253. ! 
  254.   
  255.       Pix                   prepend(const void*);
  256.       Pix                   append(const void*);
  257. *** ./libg++/src/SLList.h.dist    Thu Oct 20 11:25:53 1994
  258. --- ./libg++/src/SLList.h    Thu Oct 20 14:26:54 1994
  259. ***************
  260. *** 49,55 ****
  261.       virtual void delete_node(BaseSLNode*node) = 0;
  262.       virtual BaseSLNode* copy_node(const void* datum) = 0;
  263.       virtual void copy_item(void *dst, void *src) = 0;
  264. !     virtual ~BaseSLList() { }
  265.       BaseSLList() { last = 0; }
  266.       void copy(const BaseSLList&);
  267.       BaseSLList& operator = (const BaseSLList& a);
  268. --- 49,55 ----
  269.       virtual void delete_node(BaseSLNode*node) = 0;
  270.       virtual BaseSLNode* copy_node(const void* datum) = 0;
  271.       virtual void copy_item(void *dst, void *src) = 0;
  272. !     virtual ~BaseSLList() ;
  273.       BaseSLList() { last = 0; }
  274.       void copy(const BaseSLList&);
  275.       BaseSLList& operator = (const BaseSLList& a);
  276. *** ./libg++/src/DLList.cc.dist    Thu Oct 20 14:24:27 1994
  277. --- ./libg++/src/DLList.cc    Thu Oct 20 14:25:59 1994
  278. ***************
  279. *** 25,30 ****
  280. --- 25,32 ----
  281.   #include <builtin.h>
  282.   #include "DLList.h"
  283.   
  284. + BaseDLList::~BaseDLList() {};
  285. + 
  286.   void BaseDLList::error(const char* msg) const
  287.   {
  288.     (*lib_error_handler)("DLList", msg);
  289. *** ./libg++/src/SLList.cc.dist    Thu Oct 20 14:26:28 1994
  290. --- ./libg++/src/SLList.cc    Thu Oct 20 14:27:26 1994
  291. ***************
  292. *** 25,30 ****
  293. --- 25,32 ----
  294.   #include <builtin.h>
  295.   #include "SLList.h"
  296.   
  297. + BaseSLList::~BaseSLList() {};
  298. + 
  299.   void BaseSLList::error(const char* msg) const
  300.   {
  301.     (*lib_error_handler)("SLList", msg);
  302. *** ./libio/procbuf.h.dist    Thu Oct 20 12:08:36 1994
  303. --- ./libio/procbuf.h    Thu Oct 20 12:09:31 1994
  304. ***************
  305. *** 30,36 ****
  306.       /* Following fields must match those in struct _IO_proc_file */
  307.       _IO_pid_t _pid;
  308.     public:
  309. !     procbuf() : filebuf() { }
  310.       procbuf(const char *command, int mode);
  311.       procbuf* open(const char *command, int mode);
  312.       procbuf *close() { return (procbuf*)filebuf::close(); }
  313. --- 30,36 ----
  314.       /* Following fields must match those in struct _IO_proc_file */
  315.       _IO_pid_t _pid;
  316.     public:
  317. !     procbuf();
  318.       procbuf(const char *command, int mode);
  319.       procbuf* open(const char *command, int mode);
  320.       procbuf *close() { return (procbuf*)filebuf::close(); }
  321. *** ./libio/procbuf.cc.dist    Thu Oct 20 12:09:05 1994
  322. --- ./libio/procbuf.cc    Thu Oct 20 12:10:10 1994
  323. ***************
  324. *** 28,33 ****
  325. --- 28,35 ----
  326.   #include "libioP.h"
  327.   #include "procbuf.h"
  328.   
  329. + procbuf::procbuf() : filebuf() {}
  330. + 
  331.   procbuf::procbuf(const char *command, int mode) : filebuf()
  332.   {
  333.     _IO_proc_open(this, command, (mode & ios::in) ? "r" : "w");
  334.  
  335.  
  336. -- 
  337. Dr. Joseph E. Sacco            | Internet: jsacco@ssl.com
  338. Sacco Scientific               | 
  339. 6 Buena Vista Street           | FAX:      (617)233-3611
  340. Saugus, MA 01906-2606          | Voice:    (617)233-4212
  341.